home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 42 / Amiga Format AFCD42 (Issue 126, Aug 1999).iso / -serious- / emulation / amigavgb_ppc / old_68k / amigavgb.doc next >
Text File  |  1999-05-17  |  5KB  |  135 lines
  1.  
  2.  
  3.                    ******* Virtual GameBoy *******
  4.                 The Portable Nintendo GameBoy Emulator
  5.                              version 0.7
  6.  
  7.                          by Marat Fayzullin
  8.                       
  9.                       email: fms@freeflight.com
  10.                             IRC:  RST38h
  11.                  WWW: http://www.freeflight.com/fms/
  12.  
  13.  
  14.                          * AMIGA VERSION *
  15.  
  16.                          by Lars Malmborg
  17.                       
  18.                       email: glue@df.lth.se
  19.                            IRC:  Glue
  20.                WWW: http://www.ludat.lth.se/~dat93lma/
  21.  
  22.          (*) GameBoy is a registered trademark of Nintendo.
  23.  
  24.  
  25.  
  26. What?
  27. -----
  28. o Amiga-ized application, i.e. uses Amiga argument parsing
  29. o Features of the Unix version are implemented
  30. o Requires OS 3.0
  31.  
  32. Why?
  33. ----
  34. Because the 0.3 version by Matthias Bethke & Michael Boese
  35. didn't work on my machine, so I had to make a new port.
  36. This port uses some of the Amiga specific code from that
  37. port, but I started off by porting the Unix 0.7, so it is more
  38. like a new port than an update of that port.
  39. The most important difference is that this port doesn't use
  40. the V40 'WriteChunkyPixels'. This will make the program run on
  41. more machines (f.ex. mine!)
  42. It has sucessfully been tested on the following machines:
  43. A1200/030 without graphics card.
  44. A3000/030 with CyberVision64 running CyberGraphX.
  45. A4000/040 without graphics card.
  46. A4000/040 with Picasso II running CyberGraphX.
  47.  
  48. How?
  49. ----
  50. This program uses the standard Amiga argument parsing.
  51. Enter 'AmigaVGB HELP' to show the options the program handles.
  52. Enter 'AmigaVGB ?' for options template.
  53. Options:
  54. Cartridge <program> - name of file to load as cartridge
  55. Verbose <level>     - Select debugging messages (default: 5)
  56.                         0 - Silent           1 - Startup messages
  57.                         2 - Illegal writes   4 - Illegal CPU ops
  58.                         8 - Bank switching
  59.                       Add numbers to activate multiple options!
  60. VPeriod <period>    - Set VBlank interrupts period (default: 10000ops)
  61. UPeriod <period>    - Number of interrupts per screen update (default: 2)
  62. Help                - Print this help page
  63. Cheat <GG code>     - Activate a GameGenie cheat
  64. Delay               - Delay line interrupts
  65. NoCRC               - Don't check cartridge CRC
  66. AutoA               - Autofire for button A
  67. AutoB               - Autofire for button B
  68. Trap <address>  (!) - Set address where to enter debug mode (default: $ffff)
  69. Colors <palette>    - Change all colors. The palette consists of four colors
  70.                       enumerated from bright to dark. A palette more like a real
  71.                       Gameboy is: 102010,104010,106010,00a000
  72. BColors <palette>   - Change background colors
  73. SColors <palette>   - Change sprite colors
  74. WColors <palette>   - Change window colors
  75. ScaleUp             - Double the size of the display
  76. PublicScreen <name> - Open windows on the named public screen
  77.  
  78. (!) Trap is only valid if AmigaVGB is compiled with DEBUG defiend.
  79.  
  80. If no cartridge is given as an argument, an ASL file requester
  81. will pop up, where you can select one.
  82. The 'Interleave' argument is present in the Amiga version only. It will speed up
  83. the game by not rendering all the lines of the display. F.ex. setting it to 2
  84. will make the emulator only rendering every second line.
  85.  
  86. Some examples:
  87.  
  88. > AmigaVGB Cartridge demos/RPN.gb Colors 000000,004000,008000,00c000 AutoA
  89.  
  90. > AmigaVGB CR demos/SPACE.gb BC 808080,404040,202020,000000 SC 000040,000080,008000,004000 WC ffff80,ffc000,a0a020,504000
  91.  
  92. > AmigaVGB 2 CR Pacman.gb BC 000000,ffff00,000080,ff8000 SC 000000,ffff00,ff0000,0000ff WC ffff00,000000,ff0000,0000ff
  93.  
  94. While the emulation is running, the following keys are of interest:
  95.  
  96.   Help       - Pop up a window showing key bindings as below
  97.   Left Alt    or '+' on key pad   - 'A'
  98.   Left Shift  or '6' on key pad   - 'B'
  99.   Right Shift or '4' on key pad   - 'Select'
  100.   Return      or '5' on key pad   - 'Start'
  101.   Cursorkeys - Joypad
  102.  
  103.   ESC        - Quit emulation
  104.  
  105. If AmigaVGB is compiled with DEBUG defined, the following keys are also used:
  106.  
  107.   F1         - Go into built-in debugger
  108.   F2         - Show LCD controller registers
  109.   F3         - Show sprite registers
  110.  
  111.  
  112. History!
  113.  
  114. Rev. 1
  115.  * Initial Aminet release.
  116.  
  117. Rev. 2
  118.  * Fixed so all keys work simultaneouslly on A1200.
  119.  * Removed rather unusable Interlace option. 
  120.  * Added ScaleUp option to enlarge the display.
  121.  * Added PublicScreen option.
  122.  * Removed crash if window wasn't opened.
  123.  * Fixed potential problem with HiColour and TrueColour on CyberGraphX.
  124.  
  125. Kredz!
  126.  
  127. Marat Fayzullin                  - VGB
  128. Matthias Bethke & Michael Boese  - Amiga port of VGB 0.3
  129. Stefan Burström                  - Testing and LOTS of general help
  130. Stefan Zivkovic                  - Testing and hints
  131. John Carehag                     - Testing
  132. Simeon Everitt                   - Testing
  133.  
  134. -Lars
  135.